home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 1 / Precision Software Applications Silver Collection Volume One (PSM) (1993).iso / windows / games / mmw31.exe / RUNTIME.DOC < prev    next >
Text File  |  1992-05-10  |  10KB  |  209 lines
  1.  
  2.          ******************* THE RUN-TIME PROGRAM ********************
  3.  
  4.          There  is  a run-time program included in this kit to display
  5.          multimedia pictures created  with  The  Multimedia  Workshop.
  6.          In most cases, you will want to include it with your pictures
  7.          on  disks  that you distribute, so that the end users will be
  8.          able to use your  pictures.  Registered  users  are  free  to
  9.          distribute   the   run-time   program  MSHOW.EXE  with  their
  10.          products.
  11.  
  12.          MSHOW runs in either of two modes, "batch" or  "presentation"
  13.          mode.  In  batch  mode, it displays one picture complete with
  14.          sound effects, etc, then waits for the user to press any  key
  15.          before  returning  control  to DOS.  In presentation mode, it
  16.          displays a series of picture files and presents the end  user
  17.          with a menu from which the user controls the presentation.
  18.  
  19.          When   MSHOW   starts,  it  looks  to  see  if  there  is  an
  20.          accompanying picture file name typed at  the  DOS  prompt  or
  21.          provided  in  the  batch  file from which you may have called
  22.          MSHOW. If found,  MSHOW  displays  that  picture  file,  then
  23.          returns to DOS.
  24.  
  25.          If there is no picture file listed with the call to MSHOW, it
  26.          looks  for  a special file on disk called MSHOW.CFG, which is
  27.          created with the BUILD option on the The Multimedia  Workshop
  28.          control  panel.   If  it  finds  MSHOW.CFG  then  it  runs in
  29.          presentation mode, using the group of picture files listed in
  30.          the MSHOW.CFG file.
  31.  
  32.          In  presentation mode, at the bottom of this first picture is
  33.          a  small  menu  allowing  the  user  to  take  one of several
  34.          actions.  They are:
  35.  
  36.          HELP   BACK   NEXT   RESUME   AUTO   GOTO   SEARCH   QUIT
  37.  
  38.          These  options  can be selected with the left and right arrow
  39.          keys then a press of the [Enter] key, by pressing  the  first
  40.          letter  of the menu item, or a sideways movement of the mouse
  41.          then a click of the left button.
  42.  
  43.          HELP displays a single screen of information about how to use
  44.          the menu (although quite unnecessary!)
  45.  
  46.          BACK shows the previous picture viewed.
  47.  
  48.          NEXT shows the next picture in your presentation,
  49.  
  50.          RESUME displays the last picture viewed during the last  time
  51.          MSHOW was used.  It does this by writing a small file to disk
  52.          containing the number of the picture currently displayed when
  53.          the  user quits the MSHOW program.  The next time the program
  54.          is started, if the user selects RESUME, it  reads  that  file
  55.          and  finds the picture so the user can continue from where he
  56.          left off.
  57.  
  58.          AUTOmate  is to display your presentation over and over again
  59.          automatically.  When selected,  MSHOW  asks  you  to  type  a
  60.          number  of  seconds. It will pause for that long between each
  61.          picture.  When  it  comes  to  the  last  picture   in   your
  62.          presentation,   it  will  start  all  over  again.   This  is
  63.          excellent for  trade  show  displays,  retailers  can  put  a
  64.          monitor  in  their  store  windows at night advertising their
  65.          products, computer  retailers  can  leave  MSHOW  running  on
  66.          computers  in  their  stores. A student at a science fair can
  67.          create a show about her project and display it at her table.
  68.  
  69.          GOTO is an electronic Table of Contents. When  selected,  the
  70.          end  user is presented with a picture of a Table of Contents,
  71.          and can type a number, and then  be  taken  to  that  picture
  72.          within your presentation.  This is optional and requires that
  73.          you make a special picture called GOTO.  If  MSHOW  does  not
  74.          find  a GOTO file, it merely ignores the GOTO request without
  75.          harm.  Making a GOTO picture is easy, and I'll tell  you  all
  76.          about it in a couple of minutes.
  77.  
  78.          SEARCH (called FIND when in the CGA-LO video mode) allows the
  79.          end  user  to  type  a word or phrase.  Then, starting at the
  80.          beginning of your presentation and working to the end,  MSHOW
  81.          quickly  searches  each picture file for that word or phrase.
  82.          If found, the picture is displayed on the screen and a  small
  83.          menu  appears to allow the end user to continue searching for
  84.          more occurrences, or return to the regular menu.  In addition
  85.          to selecting SEARCH with the mouse or menu bar, the user  can
  86.          press  [S] or [F] to begin a search.  As you might expect, it
  87.          works rather slowly when a big presentation is  on  a  floppy
  88.          disk.
  89.  
  90.                                      QUIT
  91.  
  92.          This is the way out to DOS.
  93.  
  94.  
  95.          ******************** MAKING A GOTO FILE *********************
  96.  
  97.          This  is  optional.  The  GOTO file is a special picture file
  98.          which is used by GOTO as a 'live table of contents.' The user
  99.          can type a number corresponding to any  of  the  pictures  in
  100.          your  presentation,  and  be  taken  to that picture.  If you
  101.          don't make a GOTO file for your presentation, the menu simply
  102.          and harmlessly ignores a user request for GOTO.
  103.  
  104.          First complete all the pictures in your presentation and  use
  105.          The  Multimedia  Workshop's  BUILD option to make a MSHOW.CFG
  106.          file. Make a note of the numbers to the left of  the  picture
  107.          files that will be key points in your presentation.
  108.  
  109.          To  make the GOTO file, start a new picture file by selecting
  110.          FILE from The Multimedia Workshop's control panel and call it
  111.          GOTO.  No  other  name  will  do,  and  it  cannot  have  any
  112.          extension.  In this file, list or illustrate the key pictures
  113.          in  your  presentation  and put a number next to them.  These
  114.          numbers are the ones to the left of the  picture  files  when
  115.          using  BUILD.   In other words, if you have created a catalog
  116.          of blacksmith's tools,  and  you  have  several  pictures  of
  117.          anvils, you need to know the number of the first picture file
  118.          of  an  anvil in your anvil section. This will be one of your
  119.          goto points.  You can have as many goto points as you can fit
  120.          onto the GOTO picture.
  121.  
  122.          You  must  also  include  instructions  for  the  end   user.
  123.          Something  to  the  effect  of:  "TYPE  A  NUMBER, THEN PRESS
  124.          [ENTER]," so they know what to do.
  125.  
  126.          When  your  GOTO  picture is done, include it along with your
  127.          other  picture  files,   MSHOW.CFG   and   MSHOW.EXE   in   a
  128.          sub-directory or on a disk, then test it  by  running  MSHOW,
  129.          selecting  GOTO,  and  typing  the  numbers  for  the various
  130.          points, and make sure the pictures you expected  come  up  as
  131.          you planned.
  132.  
  133.          Note:  There is a sample GOTO file included on The Multimedia
  134.          Workshop disks for use  with  The  Multimedia  Workshop  Demo
  135.          Show.  Take a look at that GOTO picture to see how it's done.
  136.          To  see  another  example,  look  at  the  file  (temporarily
  137.          renamed)  GOTO.PEN  included  with  this program merely as an
  138.          example. GOTO.PEN requires VGA graphics.
  139.  
  140.  
  141.                                 RENAMING MSHOW
  142.  
  143.          Using the DOS command REN (Rename) you can  change  MSHOW.EXE
  144.          to  BEGIN.EXE  or GO.EXE, or you can make a batch file called
  145.          GO.BAT or START.BAT (etc) that starts MSHOW.  This  makes  it
  146.          easier for the end user to start your presentation.
  147.  
  148.                            USING MSHOW IN BATCH MODE
  149.  
  150.          Batch  mode  is  for  displaying  a single multimedia picture
  151.          along with its sound effects and animation, or for use within
  152.          batch files.  MSHOW will simply show a picture, then wait for
  153.          the user to press any key.  When a key is pressed, control is
  154.          returned to DOS.
  155.  
  156.          To use batch mode from the DOS prompt, type MSHOW,  a  space,
  157.          then  the  name of the picture file that you want to display.
  158.          For example:
  159.  
  160.             MSHOW C:\PICTURES\SPIDER.3
  161.  
  162.          or
  163.  
  164.             MSHOW SPIDER.4
  165.  
  166.          if your picture file is in the same place as MSHOW.EXE.
  167.  
  168.          If  you have a few pictures you want to display, and you want
  169.          to use a batch file to line them up,  you  can  do  something
  170.          like this:
  171.  
  172.          Make  a batch file called BEGIN.BAT, and in it, include these
  173.          lines:
  174.  
  175.          MSHOW SPIDER.1
  176.          MSHOW SPIDER.2
  177.          MSHOW SPIDER.3
  178.          MSHOW SPIDER.4
  179.  
  180.          When this batch file is run (when the  user  types  BEGIN)  a
  181.          picture  of  a  spider,  your  picture  called  SPIDER.1 will
  182.          appear.  When the user is through studying the  first  spider
  183.          and  presses  any key, your next spider picture, SPIDER.2, is
  184.          shown, and so on until all four pictures have been shown.
  185.  
  186.          And of course you can also use the batch file  to  run  other
  187.          programs, for instance:
  188.  
  189.          MSHOW MY_INTRO.PIC
  190.          MYPROG.EXE
  191.          MSHOW END.PIC
  192.  
  193.          The more you learn about batch files, the more things you can
  194.          do in the way of mixing and matching programs, picture files,
  195.          more  programs,  etc.  For instance, you could make a catalog
  196.          disk  which  is  mostly text, but in between displaying price
  197.          lists with a text presentation  program,  you  could  display
  198.          pictures of your more popular or interesting products.
  199.  
  200.          NOTE: If you have chosen any typefaces beyond the first  two,
  201.          BITMAP  and  TRIP,  within  The  Multimedia  Workshop,  their
  202.          corresponding disk file(s), *.CHR, must be copied  onto  your
  203.          presentation disks along with your picture files.
  204.  
  205.          _____________________________________________________________
  206.                                                         end of chapter
  207.  
  208.  
  209.